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Preface 



This manual describes the Symbolic Editor - a disk file 
editing utility which allows you to examine, analyze, 
and modify the contents of disk files. The Symbolic 
Editor (SEDIT) works on random or contiguous files 
produced within Data General's Real-Time Disk 
Operating System (RDOS) or Diskette Operating 
System (DOS). 

SEDIT resembles the RDOS symbolic debuggers very 
closely (although it cannot set breakpoints or run a 
program). 

This manual is organized as follows: 

Chapter 1 introduces SEDIT, describes special 
characters, and explains SEDIT error 
responses. 

Chapter 2 tells you how to invoke SEDIT from the 
CLI; then it describes the commands 
which change output and enter data. 
Examples show you how to open, 
examine, and modify the contents of 
save, overlay, and text file locations. 

Chapter 3 begins by describing the special SEDIT 

registers; it then explains how you can use 
these registers to find and modify 
locations. 

Chapter 4 covers SEDIT symbol recognition: how to 
disable and enable global and local 
symbols. 

Chapter 5 summarizes the SEDIT commands 
alphabetically. We have printed this 
chapter on yellow stock for easy 
reference. 

Appendix A lists the SEDIT error messages and 
explains their causes. 



Reader^ Please Note: 

We use these conventions for command formats in this 
manual: 

COMMAND required [optional] ... 

Where Means 

COMMAND You must enter the command (or 
its accepted abbreviation) as 
shown. 



required 



You must enter some argument 
(such as a filename). Sometimes, 



we use: 



1 required if 
I required 2 1 

which means you must enter one of 
the arguments. Don't enter the 
braces; they only set off the choice. 

[optional] You have the option of entering 
this argument. Don't enter the 
brackets; they only set off what's 
optional. 

You may repeat the preceding 
entry or entries. The explanation 
will tell you exactly what you may 
repeat. 

Additionally, we use certain symbols in special ways: 

Symbol Means 



) 



a 



Press the RETURN key on your 
terminal's keyboard. 

Be sure to put a space here. (We use 
this only when we must; normally, 
you can see where to put spaces.) 
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All numbers are octal unless we indicate otherwise; 
e.g., 35io. 

Finally, we usually show all examples of entries and 
system responses in THIS TYPEFACE. But, where we 
must clearly differentiate your entries from system 
responses in a dialog, we will use 

THIS TYPEFACE TO SHOW YOUR ENTRY ) 
THIS TYPEFACE FOR THE SYSTEM RESPONSE 
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For example: 

START/ 020440 ; LDA O.OVLY 

Here, the person at the console typed START/ and 
SEDIT returned 020440. Then the person typed ; and 
SEDIT returned LDA .QVLY. 



End of Preface 
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Chapter 1 
Introduction 



Data General's Symbolic Editor (SEDIT) allows you to 
edit disk file locations symbolically in any random or 
contiguous file created on an RDOS or DOS system. 
SEDIT is compatible with the RDOS debuggers and 
shares many commands with them. (To emphasize this 
similarity, we use the terms "location" and "address" 
interchangably within this manual.) 

With SEDIT, you can display and modify locations in 
octal, or in instruction, system call, byte, or ASCII 
format. You can display whole blocks of words and use 
special registers (described in Chapter 3) to find and 
modify locations. SEDIT works best on programs 
which have been loaded with a program symbol table, 
and on text files. You caw patch operating system files 
with SEDIT, in octal -- but you may find the ENPAT 
and PATCH utilities easier to use for this. 

SEDIT is unique among Data General disk editors in 
that it searches the disk file for symbolic values. For 
example, take the instruction JSR @ 50 in a program. 
Using symbols, SEDIT might display this as 

JSR @ .SAV 

which tells you about the symbolic address for the JSR. 
SEDIT can also access a program's overlay file from its 
save file. 



registers, and enable or disable symbol recognition. 
Local commands open and close locations and display 
data words in different formats. 



Note on Consoles 

The following guidelines apply not only to SEDIT, but 
to all other RDOS disk editors and symbolic debuggers. 

If you have an upper/lower case console, set it on 
ALPHA LOCK before trying to use these utilities, 
because they don't recognize lower-case letters. 

One command common to all utilities has been called 
LINE FEED {[) in our manuals. ANSI-standard 
terminals, like Data General's DASHER printer or 
display Model 6053, do not have a LINE FEED key; 
instead, they have a NEW LINE key, and you can press 
NEW LINE to enter this command. On a non-ANSI 
standard console, press the LINE FEED key. In this 
manual, we call this cnmmand T^L/LF 3"*^ eVin\y if qc 
(1). ' '" " '"-— — " 

Another common command has been called SHIFT-N 
(t). On a DG upper/lower case console, press SHIFT-6 
instead of SHIFT-N to enter this command. In this 
manual, we call this command uparrow and show it as 
(t). 



Commands 

Each SEDIT command is a single character, which you 
sometimes precede with ESC (echoed as $), an 
address, or a symbol. SEDIT has both global 
commands and local commands. Global commands 
direct searches, display ranges of locations, set 
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Special Characters 



As mentioned in the Preface, we use italic type in 
examples to indicate SEDIT output, and boldface type 
to signify your input. All numbers are octal, unless 
shown otherwise. Other special keyboard characters 
and their meanings are: 

Character Meaning 

CTRL-A Interrupt the current SEDIT command 

(Press CTRL and return the SEDIT prompt, 
and A keys) 



CTRL-Q 
CTRL-S 



Resume console display from the point 
at which CTRL-S suspended it. 

Pause while displaying output on the 
console. CTRL-S/CTRL-Q are useful 
for long displays on CRTs. They work 
on all DG consoles. 

Carriage RETURN. 

Uparrow. Press SHIFT and 6 or SHIFT 
and N keys. 

ESC. Press ESC key. 
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Typing Errors 

If you make a mistake while typing input to SEDIT 
before you press ), press the RUBOUT key. SEDIT will 
respond with U , close the current location, and display 
its prompt on a new line. You can then type another 
command. 

Actually, you can use any undefined character to do 
what RUBOUT does, but RUBOUT is most 
convenient. 



SEDIT Error Responses 

SEDIT has two common error responses: U and ?. 
(Other SEDIT error messages are explained in 
Appendix A.) 

U means that the characters you've typed are 
undefined. This can result from a simple mistake, 
or it may mean that your program doesn't include a 
symbol table, or that you have not enabled this 
symbol. 

? means that your command syntax was wrong. 
Global commands must start on a new line, 
immediately after the prompt. This can also occur if 
you type more than six octal numbers, or any value 
which exceeds 2'* -1 (e.g., 277777 or 88000.), or 
numbers, or if you use a space in an expression 
(e.g., START D +10). 

After it detects an error, SEDIT closes the current 
location (if open), and outputs a carriage return and its 
prompt. These errors do no harm. 



End of Chapter 
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Chapter 2 
Operating SEDIT 



This chapter tells you how to execute the SEDIT 
program from the CLI. It also shows you how to 
include a symbol table (which you need to edit a save 
file symbolically), and describes ihe commands to 
change SEDIT output format and input new 
information. Then it explains editing an overlay file, 
and ends by showing you how to edit a text file. 

Invoking SEDIT 

You invoke the SEDIT utility with the command: 

SEDIT filename ) 

where the filename is the name of any RDOS or DOS 
random or contiguous file. 

SEDIT searches for the filename specified; if it can't 
find the filename and you omitted an extension (e.g., 
.SV), SEDIT searches for the filename with the .SV 
extension. Because SEDIT allows you to edit any 
overlay for any node from the save file, it is generally 
easier to edit an overlay file while editing the save file 
than to edit the overlay file directly. 

When SEDIT finds the file, it opens it, then displays a 
revision number and a period prompt (.). You can then 
enter SEDIT commands. If the file is read- or 
write-protected, SEDIT displays a PROBLEM 
READING FILE error message and returns to the CLI 
when you try to read or modify the file. 



When you have finished editing, type ESC Z (echoed 
as $Z) to terminate SEDIT and return to the CLI. For 
example: 



SEDIT MYPROG ) 
SEDIT REV x.xx 



.START/ 020451 



$Z 

DONE. 

R 



Global Switches: 



Invoke SEDIT. 

The period is SEDIT's prompt. 
Enter SEDIT commands. 
Return to the CLI. 



/N Do not search for a symbol table. Use this switch 
along with global /Z to edit a text file, or if the 
oroeram lacks a symbol table. SEDIT mav display a 
NOT ENOUGH MEMORY FOR SYMBOL 
TABLE error message if the program lacks a 
symbol table and you use /Z without /N. 

/Z This file starts at location zero. You must use this 
switch to edit a text file or stand-alone program 
file; do not use it for a conventional save file. 
Programs you can execute under RDOS begin at 
location 16; SEDIT assumes this if you omit /Z. 
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Including Symbols in Save and 
Overlay Files 

If you want to edit a save file symbolically (instead of 
exclusively with octal locations), you must include user 
symbols. SEDIT will not recognize any symbols at all 
unless the program includes a program symbol table. 
You can instruct RLDR to include both a symbol table 
and debugger with the RLDR/D switch; or you can 
have it include a symbol table alone by writing a .EXTN 
.SYM. statement into one of the program modules. 

If the program includes a symbol table, SEDIT 
automatically recognizes global symbols (those 
specified in a .ENT psuedo-op in the program). To use 
/oca/ symbols (those not identified by .ENT), you must 
insert the global /U switch in the assembler command 
line, and the local /U switch in the RLDR command 
line. Having included local symbols, you then tell 
SEDIT to see them with the SEDIT command name%. 

For example, assume that you want to include all 
symbols from two source files (named MYPROG and 
MYPROGl) in save file MYPROG. You'd follow these 
steps: 

!MAC/U MYPROG; MAC/U MYPROGl | 
ASM/U MYPROG; ASM/U MYPROGl ( 



RLDR/D MYPROG/U MYPR0G1/U $LPT/L) 



This produces save file MYPROG.SV, and sends the 
load map to the line printer. (It's very helpful to have a 
copy of the map.) If either MYPROG or MYPROGl 
included a .EXTN .SYM., you could omit the RLDR 
global /D switch. 

To enable local symbols in overlays, you'd append 
global /U to each overlay name; e.g., RLDR/D 
MYPROG/U MYPROG1/U [OVLYO/U, 0VLY1/U]. 

SEDIT MYPROG ) 
SEDIT RE Vx.xx 
.MYPROG% 
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SEDIT Command Format 

All SEDIT commands have the format: 

[address] command [reply] [new-contents] [) ] 

The address can be a number, symbol or period. Each 
SEDIT command is a single character. Commands 
which display an address are entered alone; these are 
called local commands. You enter other commands by 
pressing the ESC key, then the command letter; these 
are global commands. You can enter multiple local 
commands on one line, but you must start each global 
command on a new line. The reply is SEDIT's response 
~ often the contents of address. You enter the 
new-contents (in any format described below) only if 
you want to modify the current contents. A carriage 
return tells SEDIT to accept the new-contents (if any) 
preceding; it also closes the current address and 
displays a new prompt. SEDIT will output a carriage 
return if you make a syntactical mistake or enter an 
undefined symbol. Here are three local commands in 
one line: 

.START/ 020440 ; LDA OER+10 LDA 0, ER + 7) 

START is an address, "/" is a local command which 
opens and displays the address symbolized by START 
and 020440 is SEDIT's response, which indicates the 
contents of the address. The semicolon (;) is another 
command, which tells SEDIT to display the contents in 
instruction format (instead of octal); LDA ER + 10 is 
SEDIT's translation of 020440 into instruction format. 
The last entry made by the user, specifies the new 
contents for address START; the ) installs the new 
contents and closes the address. 

An example of a global command is: 

.$H 000000 1 ) 

This opens the output register (described in Chapter 
3), and stores 1 in it; this sends all output of search 
commands to the line printer. Global commands 
remain in effect until you change them. 



Chapter 4 describes enabling and disabling user 
symbols. 
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Location and Display Commands: 

Location commands open and close locations; display 
couiuianus siiOw" tiic contents oi tuese locations in 
different formats. When you open a location, it 
becomes the current location; this does not change until 
you access another location. 

Location Commands 
Command Effect 



addr/ 



addrl 



Open address addr and display 
contents. 

Open address addr and display 
nothing. 



I (NEW LINE Close current address (if open), open 

or and display next address. (Use NEW 

LINE FEED) LINE if your terminal lacks a LINE 

(NL/LF) FEED key.) 



t (SHIFT-N 

or 

SHIFT-6) 

) (RETURN) 



/ (slash) 



Close current address (if open), open 
and display preceding address. 



Close current location (if any); return 
prompt. The closed location remains 
the current location. 

Close current location (if open) and 
open location specified by contents of 
current location. This is useful for 
pointers (e.g., .LOAD/ LOAD I LDA 
TEMP). 

Display current location in current 
radix (e.g., 5005). 

Display current location symbolically 
(e.g., LOOP + 6). 



When a location is open, SEDIT will generally try to 
insert whatever you type as the new contents for that 
location. If you don't want to modify the contents of an 
open location, be sure to close it with one of the 
commands above before typing new data. If you do 
type characters which you don't want SEDIT to try and 
insert in this location, press RUBOUT; this closes the 
current location without changing anything. 
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Display Commands 

The display commands act on the last entry which 
appears on the console. This can be an entry which you 
have typed in, or which SEDIT has displayed; or it can 
be an address or the contents of an address. 

Command Effect 

- Display last entry in current radix (the 

default is octal). A .= command 
displays the current numeric location. 

■ Display last entry in machine 

instruction format (e.g., MOVS 0). 

' (apostrophe) Display last entry in ASCII format (e.g., 
HI or <n><n> if nonprinting 
characters). 

\ (backslash) Display last entry in .SYSTM command 
format (e.g., .RDLO). 

«— (backarrow Display last entry in half-word format 
orSHIFT-O) (e.g., 14 17). 

& Display last entry in byte-pointer format 

(e.g., 30071). 

Display last entry in symbolic format 
(e.g., LOOP -I- 20). 

* Display last entry in symbolic format 

with bit zeroed. 

. = Display current numeric location (e.g., 

005005). (As with other utilities, you 
can enter a period (.) to indicate the 
current location.) 

. ; Display current symbolic location (e.g., 

START). If no symbol is defined within 
2000 locations, : displays location 
numerically. 

n.= Display decimal number n in current 

radix (default is octal). See Chapter 3, 
Number Register, for other 
conversions. 

nxH= Display hexadecimal number nx in 

current radix, n must be a digit from 
0-9; X can be any hex number(s) or hex 
letter (s). 

Figure 2-1 shows examples of the local commands 
shown above. 
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SEDIT MYPROG } 
SEDITREVx.xx 
.START/ 020440 ) 
. =000452) 
. ..START) 
.START! ) 

.1 

START+ 11264001 

START+2006017] 

START+ 1126400) 
. .-.START+li 
START+2006017 
.1 146032 ) 

ST ART + 2/ 006017 
,JSR@OVLYl + 16 
• < 14> <17> 
\.WRB17 
_1417 
i. 30071 
-.6017 
'6017 

.-.START +2 
.9999.= 023417 
0?H= 000017 
2FFAH= 027772 



Invoke SEDIT. 

Open address START and display its contents (octal by default); close location with }. 

Current address remains 452, 

which is START symbolically. 

Open address START without displaying contents; close location. Address remains 

START. 

NL/LF closes current location (if open); then opens and displays next location. 

Close START + 1 ; open START + 2. 

Uparrow closes current location (if open); then opens and displays previous location. 

) closes. 

Current address remains START+ 1. NL/LF opens next: START + 2 contains 6017. 

Use contents of START +2 (6017) as address; open and display address 6017. 

Open and display START + 2 in octal, 

display in machine instruction format 

then in ASCII format (nonprinting values), 

then in .SYSTEM command format, 

then in half-word format, 

then in byte-pointer format, 

then in symbolic format (not a symbol), 

then in symbolic format, OBO (here there is no difference between : and *), 

then, display current location symbolically. 

Convert decimal 9999 (period indicates decimal) to octal. 

Convert hex numbers F and 

2FFA to octal. 



-Figure 2-1. Local Commands Example 



You can convert most display commands into global 
commands by typing ESC, then the command. SEDIT 
then displays contents of addresses in the new format 
until you change it again. You can continue to use other 
display commands as usual. For example: 



.START/ 020440 ) 
.$; 

.START/LD^O^^ + 701 
START+ 1 SUB 1 1 [ 
START+2JSR @ 0V1+16\ 
START+31SZ0\.OVOP0) 



.START + 3/ 072000 



Octal mode. 
Change display mode. 

New mode 
continues.... 



Display 
format. 



in other 



Change mode. 

New mode continues. 



You can enter new contents for an address in any 
mode, including the special data entry modes described 
next. For example: 

.START + 35/ 125120 ;MOVZL 1 1 MOVZR 1 1 



SEDIT also allows you to examine radix 50 symbols. 
All user symbols are stored in radix 50 in the program 
symbol table; this allows any symbol to fit in two 16-bit 
words. You can use the left brackets to display the 
symbol name. The format is: 

firstword[secondword[ 

For example, assume that you are stepping backward 
through a symbol table: 

T.OVL+ 271 000000] 
T.OVL+ 270 131401] 
T.OVL+267 inOM^Z-^AOA [113024[/?00r 

(This works because RLDR builds the symbol table 
downward - not upward as it does the rest of the save 
file.) You need not actually type the numbers before 
the brackets -- simply type the bracket after the 
appropriate number appears: 

T.OVL+ 271 000000] 
T.OVL+ 270 1314011] 



Change contents of START +35 from MOVZL 1 1 to 
MOVZR 1 1, then verify the change. The display mode 
remains octal throughout. 



To do this, remember to stay in synch ~ every second 
bracket must follow the first word of the symbol. 
Symbol entries in the table are three words long. 



2-4 
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SEDIT also offers two special data entry formats, which 
allow you to translate ASCII characters, or bytes into 
any format, or enter characters or bytes in the current 
open location. To enter ASCII characters, precede 
them with a quotation mark ("). You can (but need 
not) enter a closing quote. For example: 

.■'AB= 040502 ;STA OER+52 'AB) 
.START/ 0220440 "AB) 
.START/ 040502 'AB 

The first line displays an ASCII AB in different 

You can use any two ASCII characters after the quote; 
e.g., "A= 040440. To enter a quote, you must type two 
sets of quotation marks. For example, to enter "A, 
you'd type A" or A. 

- w W...V VUI.M .ii v^ vx/kj, MLJw niw ivy.iiiiui. IIJII, v» iiwi W II li3 a, 

byte of information. For example: 

.10)1= 00400r <10><1> ) 
.START/ 02044037710) 

The first line displays the word containing 10 in its left 
byte and I in its right byte. The second line inserts a 
word containing bytes 377 and in location START. 

If n is too large, SEDIT includes only the digit(s) which 
fit into eight bits. 

Calculations 

SEDIT has two arithmetic operators, plus ( + ) and 
minus (-). You can use these operators for calculations, 
or to access locations. For example: 
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.4567 + 123=004772 
.999. + 5678.= 015025 

.START/ 020440 

.START= 000452 

. . + 12= 000464/126400 



.ER= 00502 



.-^Q= 000454/ 006017 



Add octal numbers. 

Add decimal numbers, 

result in octal. 

START contains 020440. 

START is location 452. 

Add 12 to current 

location, result is 464, 

open location 464. 

ER is location 502; 

current location remains 

464. 

Subtract 10, result is 454, 

open location 454. 



Examples 



Assume that you have determined with a debugger that 
you want to change an instruction in a program -- we'll 
call it WRITE.SV. You can't or don't want to change 
the source program and reassemble and reload this 
program; you simply want to run it. 



SEDIT WRITE ) 
SEDIT RE Vx.xx 

WRITE% 

Get into SEDIT and enable local symbols. 
.START+10/ 020445; IDA 0START+35\.CCON45 

Display the contents of START+10 in octal, 
instruction, and system call format (the latter is 
meaningless). 

START+ 11 0006017 :JSR @ 771 
START+12021027;LDA0272 

After examining succeeding locations, you decide to 
change the display mode to instruction format because 
you're looking for a machine instruction. 

} 

.$: 

.START + 32/ JMP START + 45 [ 

START + 33 IDA 2START+ 71 [ 

STAR T+ 34 IDA 1 STAR T+ 74 \ 

STARTS- 35 AND 12 AMDS 1 2 ) 

Find the faulty instruction and change it to ANDS 1 2. 
Verify the change: 

START+35//4A^D5'/2) 

And leave SEDIT: 

$Z 

DONE 
R 

You can now run the program. 

Editing OYer!ays($0) 

Using SEDIT, you can edit any overlay as if it were part 
of the save file. SEDIT opens the overlay file and reads 
the overlay you specify into its node; after editing, it 
writes any changes you make back to the overlay file. 
You can read any overlay into its node at any time. 

If you have identified an overlay with the .ENTO 
pseudo-op, you can read the overlay into its node by 
typing: 

overiaynameSO 

If .ENTO was omitted from the overlay, you must 
specify the node number and overlay number: 

node]overlay$0 

where node is the node number (0 for the node defined 
by the first pair of brackets in the RLDR command 
line, 1 for the node defined by the second pair of 
brackets, and so on), and overlay is the overlay number 
(0 for the first binary within the square brackets, 1 for 
the second binary within the square brackets, and so 
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on). We used byte entry to enter the node and overlay 
numbers; you can use a word with the node number in 
the left byte and overlay number in the right byte (e.g., 
for node zero, overlay zero, 1 for node zero, overlay 
1, and so on). 

For the rest of this section, we'll be using a save and 
overlay file created by the command line: 

RLDR/D ROOT/U [OVLYO/U, 0VLY1 /Ul ) 

This creates save file ROOT.SV, with one node, and 
overlay file ROOT.OL, which holds overlays OVLYO 
and OVLYl. OVLYO and OVLYl contain a .ENTO 
OVLYO and an .ENTO OVLYl statement, 
respectively. RLDR's load map shows that the overlay 
node begins at location 5 1 7 and ends at 1 1 1 7. 

You can enable or disable symbols at any time, as 
described further in Chapter 4. When you enable 
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symbols in one module, you disable symbols in the 
current module. 

When you load another overlay after you have enabled 
symbols in an overlay, SEDIT displays symbols exactly 
as they were in the original overlay. For example, in the 
second overlay below, PRNTB might have really 
contained the instruction LDA 0, FILEA instead of 
LDA B. This can be very confusing, so you can clarify 
overlay symbols by following this sequence when you 
want to edit successive overlays in the same node: 

1. Enable local symbols if you need them for next 
step. 

2. Get to node start and enable symbols in the desired 
overlay (ovlyname%) . 

3. Read in the desired overlay (ovlynameSO or 
node]ovly$0). 

4. Edit the overlay. 

5. Re-enable symbols in the root program (e.g., 
ROOT%);gotostep2. 



SEDIT ROOT ) 




SEDITREVX.XX 




.ROOT% 


Enable local symbols. 


.5A5/ 027117 '.01 


Approach the node start (this is the end of the overlay file text string. 




ROOT.OL.) 


OFILE+ 4 046000 'L<0> I 


Symbol OFILE points to the overlay file name. 


PRNTB 000000 . = 00051 7 [ 


PRNTB is vacant, as is the rest of the node. There's a value for it in the first 


PRNTB+1 000000 [ 


overlay. 


PRNTB +20000001 




PRNTB +3 000000) 




.OVLY0$0 


Load OVLYO into its node (without .ENTO, you'd use OlOSO). 


.5-i5/ 027117'. Oi 






Approach node as before... 


OFILE+ 4 046000 ' L < > i 


Same value at 516. 


PRNTB 020407 


A value for PRNTB! It is an instruction. The overlay is in the node. 


\ LDA PRNTB + 7 [ 




PRNTB + 1 006017 


PRNTB + 1 holds an instruction, and PRNTB + 2 holds a system call. 


■JSR @ NSW+16\ 




PRNTB +2 010000 \ .PCHA \ 




PRNTB +3 002430 


And PRNTB+3 holds another instruction. 


;JMP @ PRNTB+6) 




.OVLY0% 


Enable symbols in first overlay. SEDIT displays LDA B instead of LDA 


.PRNTB/ 020407; LDA OB i 


PRNTB + 7. 


PRNTB + 1 006017 


Enabling overlay symbols doesn't affect display of PRNTB + 1 or PRNTB + 2. 


;JSR @ NSW+16\ 




PRNTB +2 01000\ .PCHA ) 




.OVLYl $0 


Load OVLYl into node - it replaces overlay 0. 


.ROOT% 


Enable ROOT'S symbols; we won't enable symbols in this overlay for reasons 




explained above. 


.5^ 5/ 020407 '.0[ 


Approach node again... 


OFILE+ 4 046000 'L<0> I 


Same value at 516. 


PRNTB 020407 


Same value - (instruction) in PRNTB. 


;LDA0PRNTB+7\ 




nn xT'm i rnn^ni'? 


o 1 :.- r*r» XTT-n i 1 /: a. i! \ T_ ^i. • ^ ^i. . _ _ _. _ _ i j _ _ i . n 


ri\iy 1 L}-r I xjxjukji / 


odiiic vaiuc 111 rivi> idt i — uiisii uciiuu/. is mis luc same uiu uvciiay ; 


;JSR m NSW+16i 




PRNTB +2 015401 \ .RDL 1 


No. This used to be 010000, .PCHA 0. The second overlay is in the node. 




— Figure 2-2. Loading and Examining Overlays 
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Text Files 

When you invoke SEDIT to edit a text file, use the 
global /Z and /N switches. Generally, you'll be 
displaying locations in ASCII mode ($'), and using the 
ASCII entry operator ("xx) and byte entry operators 
(n]n). 

To help illustrate, assume that you have created a text 
file via the CLI by typing: 

XFER/A$TTIFILEA/R ) 
MESSAGE HELLOiDISK ) 
CTRL-Z 

You need the /R switch in RDOS to organize the file 
randomly. (The text editors automatically create 
random files.) 

Now you invoke SEDIT by typing: 

SEDIT/Z/N FILEA ) 
SEDITREVx.xx 



The /Z switch tells SEDIT that the file begins at 
location zero; if you forgot it, SEDIT would display the 
first 15 (octal) location contents as 0, and you could not 
edit the file accurately. The /N switch instructs SEDIT 
not to look for a symbol table; if you forgot it, SEDIT 
might display a NOT ENOUGH MEMORY FOR 
SYMBOL TABLE error message and return to the 
CLI. 
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Now, check the locations and add a CLI command: 



.0/ 046505 Mt ) 


ine iirst two locations 




contain "ME". 


.$• 


Change to ASCII Display. 


•i 


Display next location: 


+ /551 


And next; 


+2AG\ 


And next; 


+3E\ 


And so on; 


+4 HE I 




+5LLI 




+ 6 0.1 




+ 7DI\ 




+ 1GSKI 


Here, the text message 




ends. 


+;;<i5><o> 1 


CR and null are the last 




nonzero words. 


+ i2<0><0> } 


Now, to add a list 




command: 


.11/<15><0> ";L} 


Use " to insert ;L in 




location 1 1 . 


.11/;L1 


Check 11 and open next 




location. 


+ ;2<0><0> "ISl 


Place IS in 12; open next 




location. 


+;j<o><o> "T/1 


Place T/ in 13, open next 




location. 


+ 14 <0><0> "N<1 ? 


You can't use " to enter 




more than two characters. 


.14/<0><0> 116)15) 


Try byte entry operator 




(n]n).116 = ASCIIN. 


.14/N<15> i 


Byte entry operator works! 


+ 7J<0><0> ) 


Location 15 is unchanged. 


.$Z 

DONE. 

R 


Leave SEDIT. 



Now, we've added the CLI command LIST/N to the 
file. Verify it: 

TYPE FILEA ) 

MESSAGE HELLO;DISK;LIST/N 

R 

We can execute the commands by typing @FILEA@ ). 

When you use SEDIT to edit a text file, it automatically 
extends the byte length of the file to an even multiple 
of 512io bytes. If you open a location beyond the 
existing end-of-file (e.g., location 1001 in FILEA 
above), SEDIT automatically extends the file to the 
next multiple of 1000 (512,o ) bytes. 



End of Chapter 
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Chapter 3 
Searches^ Displays and Registers 



The material in this chapter and the next relates 
primarily to editing save files, not text files. 

v-'iitii y\ju will waiii i-u d&aivU a iiic lui a apc;uiiii^ wuiu, 

or display entire blocks of words on the console or line 
printer. This chapter explains the search and display 
commands and the special SEDIT registers which can 
help you use these commands effectively. 



Search Command ($S) 

With the Search command ($S), you can search 
forward in the file for the contents of any address (e.g., 
JSR @ 17). To search to a location, type addressSS , 
and SEDIT will search forward from address zero and 
stop when it reaches address. 

To search for the contents of an address, you must 
open the Word register with the $W command, type the 
word you want SEDIT to find, and close the Word 
register. Then you type $M to open the Masic register, 
enter a mask word, and close it. If the Mask register 
contains zero (default), the search will match all words 
in the file. To match a specific word, instead of a 
general group, enter -1 (177777) in the Mask register. 



You can also set an increment for the search with the 
Search Increment Register; you can direct output to the 
line printer by placing 1 in the Output register. 

Having set these registers (which are described later in 
this chapter), you enter your Search command, and 
SEDIT seeks matching contents in the file. 

The formats of the Search command are: 



addr$S 


Search from location to addr. 


$S 


Search entire file for value in Word 




register. 


<addr$S 


Search from location zero to addrfor 




value in Word register. 


addr<$S 


Search from addr to last location for 




Word value. 


addr<addr$S 


Search from addr to addr for Word 




value. 



If you omit addr, SEDIT assumes zero as the lowest 
address and 77777 as the highest address. When SEDIT 
finds a word matching the contents of the Word 
register, it displays addr and its contents in the current 
display mode. If you have enabled symbols, it displays 
locations symbolically, as in Figure 3-1. 
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SEDIT ROOT ) 
SEDITx.xx 

ROOT% 
.ER$S 
+0000000 
OVLY 1000000 


Enable local symbols. 

Display file to location ER. 

SEDIT always searches for locations from location 0; thus it may take 

some time to reach location ER 


RTURN+ 2 000401 

ER 006017 

. .= 000503. -.ER + l) 


Found! 

Current position is 503, symbolically ER + 1. 


.$W 000000 JSR@1 7) 

.$\N006017;JSR@ +17) 

.$M 000000 -^ ) 

.$S 

START+ 2 0006017 

START +6 006017 


Now to find locations containing JSR @ 17. First, place JSR @ 17 in Word 

Register. 

Verify new value in Word register. 

To match a word specifically, place -1 in Mask register. 

Search the save file for JSR @ 17. SEDIT displays the locations 

symbolically that contain JSR @ 17. 


DEBUG+01277 006017 
.$; 
.$S 

START+2JSROV1 + 16 
START + 6 JSROV 1 + 16 


Change display to instruction mode. 

Search again. 

SEDIT displays contents in instruction format. 


DEBUG + 1277JSR @0V1+16 
.$K 
$S 

+454JSR@17 
+460JSR® 17 


Kill all symbols (see Chapter 4). 

Search again. 

Display locations in octal, contents in instruction format. 


2515JSR@17 
.1$K 


Re-enable global symbols. 




- Figure 3-1. SEDIT $S Command Example 



Another example is: 

.$W 000000 .WRL 0) 

.$M 000000 -^ ) 

.$\ 

.400 <$S 

5536. WRL 
7666. WRL 



Insert .WRL in Word register. 
Insert -1 in Mask register. 
Change to .SYSTM call mode. 
Search from location 400 
upward. 

Display in system call format. 
There are two write lines to 
channel in this program. 



See the register sections below for more examples of 
the Search command. 

Display Command ($D) 

The Display command ($D) resembles the Search 
command, except that it cannot search for the contents 
of a location, and it displays the contents of eight 
locations on one line. You can display on the line 
printer by setting the Output register to 1, and you can 



set the Search Increment register to display locations at 
desired increments. The SD command always displays 
contents in octal; you cannot change the output of $D 
to other formats. 

The formats for the Display command are: 

addr$D Display contents from location to 

addr. 
$D Display contents of all locations. 

addr<$D Display from location addr to last 

location. 
addr<addr$D Display from addr to addr. 

Figure 3-2 shows display examples. The first example 
displays locations one through 20, and locations 400 
through 450 in a save file. Like most save files, this one 
uses only location 17 (in first range); its User Status 
Table, TCB(s), and overlay directory (if any) start at 
400 (second range). The second example displays 
locations in a text file. 
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SEDIT ROOT ) 

SEDITREVx.xx 

20$D 

+0 000000 000000 000000 000000 000000 000000 000000 000000 

OVLYl + 7 000000 000000 000000 000000 000000 000000 000000 001155 

OVLYl + 17 000000 

.400<500$D 

"USTAD 000000 000060 006634 006114 006635 001120 001216 006635 
USTAD + 10 000000 177777 177777 000410 000424 000424 177777 00452 
USTAD+20 000445 000000 177777 000000 001124 000000 000000 000000 
USTAD +30 000000 000000 000000 177777 000000 000000 000000 000000 
USTAD +40 000000 000000 000000 000000 000000 000001 177400 001001 
USTAD + 50 000000 000517 020440 126m 006017 012000 000424 020426 
START+6 006017 010000 000420 020423 126400 006017 020000 000413 
LOVO+5 002420 020416 126400 006017 020000 000405 002413 006017 
RTURN+1 004400" 



$Z 

DONE. 
R 

SEDIT/N/ZTESTFILE) 
SEDIT REV. x.xx 
.0 10$D 

+0 046505 051523 040507 042440 052110 044523 020111 051440 
+ 10 052105 



Figure 3-2. Displaying Locations 



SEDIT Registers 



SEDIT registers are locations into which you can insert 
values. These values control I/O and numeric output, 
searches, and displays. There are five registers: Output, 
Number, Search Increment, Mask, and Word. You can 
use all the registers for searches; you can use the first 
three for displays. 

The value in each register is initially zero (except for 
the Search Increment Register). Any value you insert 
reverts to the default when you leave SEDIT and 
return to the CLI. 

Output Register ($H) 

By default, SEDIT sends Search and Display output to 
the console. You can direct this output to the line 
printer by entering the value 1 in the output register. 
Use the $H command to open and examine this 
register; you can then change it if you want. For 
example: 

$H 000000 1 } 

directs output of Search and Display commands to the 
line printer. When output of Search commands goes to 
the printer, SEDIT inserts the value (in current output 
mode) of the sought word before the contents of each 



address. Display command output is the same on both 
console and printer. 

Number Register ($N) 

By default, SEDIT displays numbers in octal, unsigned, 
with leading zeroes. You can tell it to output numbers 
with a leading sign, suppress leading zeroes, or select 
radix 8, 10, or 16 by placing the proper value in the 
number register. Use the $N command to open and 
examine this register; you can then insert a new value if 
you want. 

New value: Setsbit(s): Effect: 



1 00000 BO Sign numbers. 

040000 Bl Suppress leading zeroes. 

000010 B12 Display in octal. 

(or 000000) none Same. 

000012 B12,B14 Display in decimal (10. 

same effect). 
000020 BU Display in hexadecimal 

has same effect). 



has 



(16. 



You can enter combinations of these values in the 
number register. If you enter any value but those 
above, SEDIT uses the default radix (octal). 
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.START/ 020440 ) 
.$N 000000 ^0. } 
.START/ 08480. ) 
A440= 02336. ) 
.$N 0000/0 140000) 



.START/ +20440) 
.$U-40000^6.) 
.START/ 2120H 
15= OOODH 



Default octal display. 
Specify decimal numbers. 
Display in decimal. 
Convert an octal number. 
Insert sign, suppress leading 
zeroes, display in octal. 
SEDIT follows orders. 
Convert to hexadecimal. 
Terminal H means hex output. 



Search Increment Register ($J) 

By default, SEDIT increments locations by one in 
Search and Display commands. You can specify a 
different increment by opening the Search Increment 
Register and inserting the increment you want. The $J 
command opens this register. 

The default value in the Search Increment Register is 
000001; a negative or value is illegal, and will produce 
the default value. 



.$N 00000040000) 
.$M 0-1 ) 
.$W0STA3, 50) 

.$8 

DEBUG +527 54050 
DEBUG +572 54050 
DEBUG + 1075 54050 
.$J74) 

$S 
DEBUG +572 54050 

.V^ 540500) 
.$S 
+ 00 

OVLYl+30 
OVLYl + 70 
OVLYl + 13 

.$J¥10) 

.<400$D 



OVLYl + 77 

OVLYl + 177 

OVLYl+277 

USTAD 

.$J701 ) 



Suppress leading zeroes. 

Set Mask register to -1 . 

Insert STA 3, 50 in Word 

register. 

Search all locations for STA 3, 

50. 



Specify increment of 4 in 

Search Increment register. 

Search again. 

There's only one STA 3, 50 at 

an increment of 4 from zero. 

Place in Word register. 

Search again. 

There are plenty of locations 

which contain 0. 



Place increment of 10 in 

register. 

Try a display command. 



Specify a search/display 
increment of 1 . 



Mask and Word Registers ($.M and $W) 

SEDIT uses both the Mask and Word registers for 
searches. If you want to search for a specific 
instruction, you must set both of these registers. As 
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you've seen earlier in this chapter, you insert the word 
you want matched in the Word register. After you issue 
the Search command, SEDIT searches each location 
and ANDs the value in the Mask register with the 
location's contents. If this value matches the Word 
register, SEDIT announces a match. The default value 
for both registers is 000000. 

Because SEDIT ANDs the mask with the contents, and 
the default mask is 000000, there will be no match 
unless you set the Mask register. To match a specific 
word, insert -1 in this register. To match only a portion 
of a word, set the bits which contain that portion to 1 in 
the mask register, and set the other bits to 0. 

The command 

$M 

opens the Mask register and displays the contents. 

Place the value you want SEDIT to match in the Word 
register. You can enter this in any format (e.g., MOVS 
0, 101300, or .WRL 0). The command 

$W 

opens the Word register and displays its contents. The 
following example shows application of the Word and 
Mask registers in Search commands. 



SEDIT ROOT ) 
SEDITREVx.xx 

.m 000000 -\ ) 

.$W 000000 .RDLO) 

$s 

5742 015400 
.15A00\. RDLO 



Set mask register to 177777 (16 

ones). 

Insert read line call in Mask 

register. 

Search all locations. 

One match. 

Check 15400; it's .RDLO. 



The Mask register can help you search for all 
occurrences of one type of instruction. For example, 
assume that you want to find all "MOVZL" instructions 
in a program. The octal instruction is 101120, but this 
applies only to MOVZL 0,0; with any other 
accumulators there will be no match. Bits 1 through 4 
specify accumulators in MOV instructions, so you 
mask them out by inserting a word which contains in 
bits 1,2,3, and 4, and 1 in the other bits. This word is 
103777: 



SEDIT SYS) 
SEDITREVx.xx 

.$W 000000 MOVZL) 

.$M 000000 103777 ) 
.<4000$S 



in 



to 



2536175120 

. 155120; A/0KZI2J) 

.1 751 20; MOKZLi J 



Insert MOVZL in Word 

register. 

Insert MOVZL mask 

Mask register. 

Search from location 

4000 for MOVZLs. 

One match. 

Two matches. 

Check the match words. 

The MOVZL mask works 



End of Chapter 
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Chapter 4 
Enabling and Disabling Symbols 



As described in Chapter 2, global symbols are those 
declared in .ENT statements in a program. To 
recognize global symbols, SEDIT requires only that a 
save file include a program symbol table. The RLUK/U 
command will include both a program symbol table and 
a debugger; a .EXTN .SYM. statement in any program 
module will include only the symbol table. SEDIT 
always recognizes global symbols (unless you disable 
them). 

SEDIT will also recognize. /oca/ symbols (those not 
declared with .ENT), if you assembled the program 
source rile(s) using the global /U switch, and ;/you 
used local /U in the RLDR command line. To enable 
local overlay symbols, append local /U to the overlay 
name in the brackets; for example: 

RLDR/D MYPROG/U MYPR0G1/U [OVLYO/U, |) 
0VLY1/U] } 

When you proceed through a file, examining locations, 
SEDIT displays each location as it relates to the nearest 
previous symbol defined. However, if the nearest 
previous symbol is more than lOOOg locations away, 
SEDIT displays the octal, not the symbolic, value of the 
location. 



Enabling Symbols 

If the program has a symbol table, SEDIT will 
understand all global symbols when you invoke it. To 
enable local symbols in any program module or 
overlay, type: 

name% 

where name is the module name, as assigned by the 
.TITL pseudo-op. The name is not necessarily the 
filename. If .TITL was omitted from the module, the 
default name is .MAIN. The name% command enables 
all local symbols in this module. It also disables local 
symbols in only one module at a time. 



To edit overlays symbolically, see "Editing Overlays" 
in Chapter 2. 

To enable global symbols after you have killed all 
symbols (SK, below), type: 

n$K 

where n is a single octal digit (1 is convenient). 

In any module, to enable all symbols that you have not 
individually disabled, type: 

name7o 

as above. 



Disabling Symbols 



If there are a lot of local symbols, they can cloud your 
overview while you are editing; also, an individual 
symbol can interfere with editing if its value happens to 
fall at the wrong point. Occasionally, even global 
symbols hamper editing. You can disable all symbols, 
or individual symbols, with the command: 

$K 



For example: 

SEDIT MYPROG } 
SEDIT REV x.xx 
.START/ 0240440 
.$K 
START/ U 



Invoke SEDIT. 

START was .ENTered. 
Disable all symbols. 
START is now Undefined. 



To disable any single symbol, type: 
name$K 

where name in the symbol name. Note that SEDIT will 
still recognize the symbol when you type it in, but 
won't display it when you proceed forward or backward 
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through locations in the file. Instead, SEDIT displays 
the disabled symbol's locations as it relates to the 
preceding active symbol (if the previous symbol is less 
than 20008 locations away - see above). 

When you disable output of a single symbol, you 
cannot re-enable it during this SEDIT session. To 
re-enable the disabled symbol, leave SEDIT and return 
to SEDIT. 

For example, assume that program ROOT starts at 
symbolic location START, and the next symbol is 
LOVO. (Here, it doesn't matter whether START and 
LOVO are global or local symbols.) 



SEDIT ROOT ) 
SEDIT REV x.xx 

.ROOT% 
.START/ 020440 \ 

STARTS 11264001 
START+ 2 006017 \ 



START +10 000420 \ 

LOVO 020423) 

.LOVOSK 

.START -I- 10/ 000420 i 

START+ 11 020423 



.LOVO/ 020423 



$Z 

DONE. 
R 

SEDIT ROOT ) 
SEDIT REV X.XX 
.ROOT% 

.START + 10/ 0004201 
LOVO 020423 



Enable all symbols. 
Open and display location 
START, then next location. 
Continue... 



Proceed to location LOVO. 

Disable LOVO for this session. 

Check START -h 10 

(unchanged). 

What SEDIT displayed as 

LOVO, it now displays as 

START+11. 

SEDIT still recognizes LOVO 

on input, but does not display 

it. 

Leave SEDIT. 



Re-enter SEDIT. 

Enable local symbols again. 
Check LOVO display... 
LOVO display is enabled. 
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Managing Symbols 

To enable global symbols while editing, you need do 
nothing if you have used the global /D switch in the 
RLDR command, or an .EXTN .SYM. statement in a 
source module. 

To enable local symbols, type name% (you must have 
used the assembler global /U and RLDR local /U 
switches). 

To disable all symbols, type $K. 

To disable the display of any symbol, type 
symbolname$K. 

To re-enable global symbols type 1$K (or any digit 
instead of 1). The sequence $K, 1$K disables all 
symbols and re-enables globals. 

To re-enable all but explicitly disabled symbols, type 
name%. 

By defauh, when you include the global /D switch in 
the RLDR command, RLDR places the debugger 
directly above your program, and places the symbol 
table (which either SEDIT or the debugger needs), 
directly above the debugger. If you use a .EXTN .SYM. 
in a program module, and omit RLDR global /D, the 
symbol table will be directly above the program. The 
load map (if you specified one with the RLDR local /L 
switch) will tell you the location of each global symbol, 
the start address of the debugger (if present) and the 
start and end address of the symbol table. If the 
program lacks a symbol table, you can use the 
addresses in the load map to patch, but this is much 
more awkward than using symbols. 

Symbol Example 

Figure 4-1 shows various attempts to disable a 
distracting symbol. 
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SEDITMYPROG ) 
SEDITREVx.xx 
.mOOOOQf) AOOOO) 
START/ 20440;LDA OER+10 
.$; 

.MYPROG% 

.START/ IDA OOFILE I 
START+lSUBll 1 



.LOOP + 4//A^C0 1 
LOOP+5COM00SZR i 
RTCNSJMPRTCNS+10 j 
R TCNS+1 STA R TCNS + 15 ) 
= 5005) 

. .:RTCNS+]) 
.$K 
.1$K 
. .-.RTCNS+l) 

.RTCNS$K 

. .■.START+27) 

.MYPROG% 

.LOOP + 6/ JMPLOOP+ 16 I 



$Z 

DONE. 

R 



Suppress leading zeroes (to help fit this example into one column). 

Display location START. 

Display in instruction mode. 

Enable all symbols. 

Local symbol OFILE replaces global ER + 10. 

Examine succeeding locations. 



Examine LOOP + 4, then next location. 

And next... 

Encounter symbol RTCNS, but we find RTCNS a little confusing. 

Check current location in octal, and symbolically. 

Disable all symbols and enable global symbols; this disables RTCNS if it is a 

local symbol. 

Check current location symbolically; find that RTCNS is still enabled -- thus 

it is global. 

Disable RTCNS specifically. 

RTCNS is not displayed. 

Re-enable local symbols. 

Continue editing. 



Figure 4-1. Disabling and Enabling Symbols 



End of Chapter 
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Chapter 5 
SEDIT Command Summary 



This chapter summarizes SEDIT commands in Table 5-1. First, it presents character commands (e.g.,.&), then 
letter commands in alphabetical order. 

Table 5-1. SEDIT Command Summary 



Command 



/ 

addr/ 

addr! 

NL/LF 

t (SHIFT-6) 

or 

(SHIFT-N) 

) (RETURN) 



$= 



$' 

\ (backslash) 

$\ 



Meaning 



[± 



Use contents as addr, open and display 
Open addr, display contents. 
Open addr, display nothing. 
Open next addr, display contents. 
Open previous addr, display contents. 

Close current location (if open), insert new value (if any), give prompt. 

Display current location in current radix. 

Display current location symbolically. 

Display last entry in current radix. 

Change display mode to numeric, current radix (default is 8). 

Display last entry as an instruction. 

Change display mode to instruction. 

Display last entry in ASCII. 

Change display mode to ASCII. 

Display last entry in .SYSTM format. 

Change display mode to .SYSTM format. 

Display last entry in symbolic format. 

Change display mode to symbolic format. 



Example 



400/ 000000 

START/ LDAOOVI 

START! 

\ START + SUB 11 

\ 

START LDAOOVl 

AND! 2 MDS^ 2} 

. = 000402 

.:START 

SUB 1 1 = 126400 

$= 

1 26400 ,Si/B 7 7 

$; 

046505' ME 

$■ 

01 7000\ . WRL 

$\ 

020423: LOKO 

$: 
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Table 5-1. SEDiT Command Summary (continued) 



Command 



Meaning 



Example 



n.= 
nxH 
word 1 lword2l 

"XX = 

"XX 

bytelbyte = 
bytelbyte 

+ 

name% 
$D 

addr$D 
addr $D 
addr addr$D 
$H 

$J 

$K 

n$K 

nameSK 

$M 

$N 

ovnameSO 

$0 

nodelov$0 

$S 



Display last entry as symbol, OBO. 
Convert decimal n to current radix. 
Convert hex nx to current radix (n = 0-9). 
Convert 2 radix 50 words to symbol. 

Display ASCII xx in current radix. 

Insert ASCII xx in open addr. 

Display byte, byte in current radix. 

Insert byte, byte word in open addr. 

Add one number to another or to an address. 

Subtract one number from another or an address. 

Enable output of all local and global symbols in module name. 

Display all locations in file. 

Display locations from through addr. 

Display locations from addr to end. 

Display locations addr through addr. 

Open output register, display contents. sends $D and $S output to console, 
1 to line printer ($LPT). 

Open Search Increment register (used in $D and $S), display contents. 

Disable output of all symbols. 

Enable all global (.ENT) symbols. 

Disable output of symbol name. 

Open Mask register (used with $W, in S commands), display contents. 
Insert -1 to match a specific word. 

Open Number register, display contents. Insert 100000 to sign output, 40000 
to drop leading zeroes, 12 or 10. for decimal output, 0,8. or 10 for octal 
output and 20 or 16. for hex output. 

Load overlay named by .ENTO into node. 

Load overlay into save file node 0. 

Load overlay ov into node node. Node number goes in left byte, overlay 
number in right byte. 

Search all locations for value in SW (also use value in SM, $J, $H for all 
Searches) . 



177777* mn 

9999. = Q2341 7 
0EF2H= 007362 
131401 [113034(/?007" 

"Hl= 044111 

000000 "H\) 

1011 =-004001 

000000 : Oh ) 

4567 + 123 = 004712 

ER-10 = 00452 

ROOT% 

$D 

<40$D 

77000<$D 

400<500$D 

$H 000000 1 ) 

$J 000001 4 ) 

$K 

1$K 

TEMP2$K 

$M 000000 -^ ) 

$N 000000 A 400] 0) 

OVLYOSO 

$0 

0]1$Oor1$O 

$S 
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Table 5-1. SEDIT Command Summary (continued) 



Command 


Meaning 


Example 


acldr$S 


Search locations from to addr. 


<40$S 


addr<$S 


Search locations from addr to end. 


77000<$S 


addr<addr$S 


Search locations addr through addr. 


400<500$S 


$W 


Open Word register, display contents. S commands search for the value in 
the Word register. 


$W 000000 STA 3,50) 


$Z 


Stop SEDIT and return to CLi. 


$2 


CTRL, A keys 


Stop current SEDIT command, return prompt. 


CTRL-A 


CTRL, Q keys 


Resume console display, suspended by CTRL-S. 


CTRL-Q 


CTRL, S keys 


Suspend console display, wait for CTRL-Q. 


CTRL-S 



End of Chapter 
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Appendix A 
SEDIT Error Messages 



V or _? 

Your SEDIT command syntax was wrong, or you 
pressed RUBOUT. SEDIT outputs a line feed and 
awaits another command 

ERROR IN ACCESSING PRINTER 

When you have directed output to the line printer (by 
setting $H to nonzero), SEDIT could not open the 
printer or could not write to it. Perhaps another 
program is using it. 

FILE IS SEQUENTIAL: filename 
SEDIT cannot edit a sequential file. 

FILE NOT FOUND: filename 

SEDIT searched for the file specified, then tried 
searching for the file with the .SV extension, but could 
not find the file. 

HAD PROBLEM OPENING FILE: filename 

SEDIT could not file, or could not open, the file 
specified. 

ILLEGAL OVERLAY ADDRESS 

This is an internal SEDIT error. The node address is 
somehow incorrect. 

ILLEGAL OVERLAY NODE NUMBER 

Either you have specified a node or overlay number 
higher than the file contains, or there is no overlay 
directory. 



INSUFFICIENT MEMORY FOR OVLY TABLE 

On an $0 command, SEDIT tried to read the overlay 
directory into memory, but there was not enough 
memory available. 

End of Appendix 



NO INPUT FILE NAME GIVEN IN COMMAND LINE 
You must specify a filename for SEDIT to edit. 

NO OVERLAY LOADED 

No overlay has been loaded ($0) into the node you 
specified. This message appears only after some overlay 
has been loaded. For example, your program has two 
overlay nodes, you loaded an overlay into one node, 
then tried to access the other node. 

NOT ENOUGH MEMORY FOR SYMBOL TABLE 

The program's symbol table won't fit into memory. 
Alternatively, the file is not a save file and you forgot 
the global /N switch, or inappropriately used the /Z 
switch. 

PROBLEMS OPENING OVERLAY FILE 

SEDIT could not read the overlay directory, or could 
-.C- wPcii vfiw V* . >^ii.^y iiiC ijhiDi 1 cxpcciS tnc ovcrisy 
file to have the same name as the save file, with the 
.OL extension. 

SOME PROBLEMS READING SOURCE FILE: filename 

An error occurred as SEDIT tried to open the file or 
read/write to it. 

U 

You have entered an undefined command or symbol. 
SEDIT outputs a carriage return and awaits another 
command. To enable /oca/ user symbols, use the global 
/U switch in the assembler command line and use the 
local /U switch in the RLDR command line; then type 
modulename% from SEDIT. 
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Index 



Within this index, the letter "f following a page 
number means "and the following page"; "ff means 
"and the following pages". 

Chapter 5 is a summary of all SEDIT commands, but 
we have not entered Chapter 5's entries in this index. 

! 2-3f 

" (quotation mark) 2-5 

$ see ESC key 

% (percent) 4- If 

& (ampersand) 2-3 

' (apostrophe) 2-3f 

* (asterisk) 2-3 

+ (plus) 2-5 

- (minus) 2-5 

. (period) 2-3f 

/(slash) 2-3f 

: (colon) 2-3f 

; (semicolon) 2-3f 

= (equal sign) 2-3 

[ (left bracket) 2-4 

\ (backslash) 2-3f 

] (right bracket) 2-5, 2-7 

t (uparrow) 

command 2-3 

definition of 1-lf 
»- (backarrow) 2-3 
) (carriage return) 1-1 

ASCII characters 2-5 

byte entry 2-5 

calculations 2-5 
commands 

definition of 2-3 

display 3-2ff 

display mode 2-3f 

format of 2-2 

global/local 2-2, 2-4, 4-lff 



location 2-3 

overview 1-1 

register 3-3f 

search 3- If 
consoles 1-1 
CTRL-A 1-2 
CTRL-Q 1-2 
CTRL-S 1-2 

display 

command 3-2ff 
mode commands 2-4f 

.ENTO 2-5 
error 

messages A-1 

responses 1-2 

typing 1-2 
ESC key 1-2,2-2,2-4 

H (output register) 3-3 
hexadecimal (H) 2-3f 

J (search increment register) 3-4 

load map 2-2 

M (mask register) 3-4 

N (number register) 3-3f 
NEW LINE key 1-lf, 2-3 
Number register 3-3f 

O (overlay symbols) 2-5 
organization of manual iii 
overlays, editing 2-5f 
output register 3-3 

registers 3-3f 

RETURNkeyO) 1-lf, 2-3 
RUBOUTkey 1-2 
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S (search) 3- If, 3-4 
search increment register 3-4 
searches 3-lf, 3-4 
SEDIT 

commands see commands 

error 

messages A-1 
responses 1-2 

invoking 2-1 

overview 1-1 

switches 2-1 

symbols, see symbols 
special characters 1-lf 
switches, see SEDIT switches 



symbols 

disabling, enabling 4-llT 

documentation iiif 

global, local, definition of 2-2 

overlay 2-5 

using 4- Iff 
symbol table 

examining 2-4 

including in file 4-2 
symbolic editor, see SEDIT 

text files 2-7 

W (word register) 3-4 
Word register 3-4 
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How Do You Like This Manual f 



Title. 



. No. 






Who Are 



G EDP Manager 

[J Senior System Analyst 

D Analyst/Programmer 

m ^ . . 

I— J wperator 

n Other 






How Do You Use This Manual? 



What programming language(s) do you use? 



(Lisi 111 order: I = Primary use) 

Introduction to the product 

Reference 

Tutoriai Text 

Operating Guide 



Do You Like The Manual? 



i %^o wUiiit^Wiiai INO 



D 


D 


n 


D 


D 


n 


D 


D 


n 


n 


D 


G 


G 


D 


G 


D 


D 


n 


G 


G 


D 



Is the manual easy to read? 

Is it easy to understand? 

Is the topic order easy to follow? 

Is the technical information accurate? 

Can you easily find what you want? 

Do the Illustrations help you? 

Does the manual tell you everything you need to know? 



Comments? 



(Please note page number and paragraph where applicable.) 



From: 



Name 



-Title. 



Adcress_ 



-Company. 



Date 
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